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1  Scope 

This  document  is  an  attachment  to  the  UGV  Interoperability  Profile  (iOP) 

Overarching  Profile  and  serves  the  purpose  of  compiiing  aii  custom  services,  messages,  and 
transports  into  a  singie  iocation.  These  services,  messages  and  transports  are  configuration 
controiied  via  the  UGV  iOP  iPT  and  approved  for  use  by  the  UGV  iOP  Executive  Board. 

Custom  services  and  messages  wiii  be  pubiished  and  distributed  to  the  RS  JPO  stakehoider 
community  without  proprietary  markings.  Custom  messages  that  cannot  meet  this  distribution 
wiii  not  be  specified  for  use  within  the  UGV  iOP. 
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2  Source  Documents 

The  following  documents/data  items  were  utilized  as  reference  source  material  in  the 
conduction  of  this  domain  analysis. 

2. 1  Government  Documents 

•  N/A 

2.2  Non-Government  Documents 

•  N/A 
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3  Custom  Services 

Custom  services  includes  all  services  that  have  been  created  specifically  to  meet  needs  of  the 
Interoperability  Profile  effort  that  are  not  already  found  in  a  published  or  draft  SAE  AS-4  JAUS 
document  (or  other  standard).  Fully  created  custom  services  declare  and  define  the  messages 
they  use  in  this  section.  For  custom  messages  attached  to  existing  services,  see  Section  4 
Custom  Messages. 


3. 1  Leader  Management  Service 

name=  LeaderManagementService 
version=0.1 

id=urn:jpo:autonomy:  LeaderManagementService 

Inherits-from  Events 
name=events 

id=  urn:jaus:jss:core:  Events 
version=1.0 


«Transport» 


«Events» 


«LeaderManagement> 


Figure  3.1-1:  Leader  Management  Service  Inheritance  Diagram 


3.1.1  Description 

The  Leader  Management  Service  is  intended  to  be  hosted  by  the  lead  subsystem  in  a 
leader/follower  operation.  The  Service  allows  followers  to  register  with  the  leader,  and  requires 
periodic  requests  from  the  followers  to  maintain  that  registration.  Furthermore,  followers  may 
request  that  the  lead  vehicle  slow  down  or  speed  up  to  improve  the  leader/follower  performance 
by  using  the  speed  override  message. 

Assumptions: 

Messages  may  be  delayed,  lost  or  reordered. 
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3.1.2  Vocabulary 


Table  3.1-1:  LEADER  MANAGEMENT  SERVICE  VOCABULARY 


Message  ID 
(hex) 

Name 

Command 

Input  Set 

FFD3 

QuervFollowers 

false 

FFD2 

ReqisterFollower 

false 

FFD1 

ReauestSoeedOverride 

false 

Output  Set 

FFD4 

ReoortFollowers 

False 

FFD5 

RegisterFollowerResponse 

False 

Table  3.1-2:  LEADER  MANAGEMENT  SERVICE  INTERNAL  EVENTS  SET 


Name 

Interpretation 

Registration  Timeout 

Occurs  when  registration 
is  not  re-acquired  within 
the  required  timeout 
period 

3.1.3  Encoding 

3.1. 3.1  Input  Set 

3. 1.3. 1. 1  ID  FFD3:  QueryFollowers 

Queries  for  a  list  of  all  active  followers. 


Table  3.1-3:  QUERY  FOLLOWERS  MESSAGE  ENCODING 

_ Empty  message  body _ 


3. 1.3. 1.2  ID  FFD2:  RegisterFollower 

This  message  allows  a  follower  to  register  with  the  lead  subsystem,  or  disconnect  (cancel)  a 
previous  registration.  While  such  registration  is  not  required  for  one  subsystem  to  follow 
another,  only  subsystems  that  have  registered  with  the  leader  can  effect  speed  changes 
through  the  override  mechanism. 


Table  3.1-4:  REGISTER  FOLLOWER  MESSAGE  ENCODING 


body 

•—  record  name  =  FollowerRec 


Record  Name  =  FollowerRec 
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Field 

# 

Name 

Type 

Units 

Optiona 

1 

Interpretation 

1 

<fixed_field> 

RequestType 

unsigned  byte 

false 

Enum  0: 
CONNECT 

Enum  1: 
DISCONNECT 

3. 1.3. 1.3  ID  FFD1 :  RequestSpeedOverride 

This  message  allows  a  follower  to  request  an  override  to  the  lead  subsystem’s  speed.  The 
override  may  be  given  as  a  percentage,  such  that  Actual  Speed  =  Override  *  Original  Speed,  or 
as  an  absolute  value. 


Table  3.1-5:  REQUEST  SPEED  OVERRIDE  MESSAGE  ENCODING 


body 

1 _ variant  name=OverrideType 

record  name=PercentRec 
record  name=AbsoluteRec 

Record 

Name  =  PercentRec 

Field 

# 

Name 

Type 

Units 

Optiona 

1 

Interpretation 

1 

<fixed_field> 

SpeedOverride 

unsigned  byte 

one 

false 

Percent.  Scale 
Range  [0...100]. 

Record  Name  =  AbsoluteRec 

Field 

# 

Name 

Type 

Units 

Optiona 

1 

Interpretation 

1 

<fixed_field> 

SpeedOverride 

unsigned  short  integer 

meters 

per 

second 

false 

Scaled  Integer 
Lower  Limit= 

0 

Upper  Limit= 
327.67 
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3. 1.3.2  Output  Set 

3. 1.3.2. 1  ID  FFD4:  ReportFollowers 

This  message  reports  a  list  of  all  followers  registered  with  a  leader. 


Table  3.1-6:  REPORT  FOLLOWERS  MESSAGE  ENCODING 


body 

1 _ list  name=FollowerList 

(count_field  =  unsigned  byte) 
record  name=FollowerRec 

Record 

Name  =  FollowerRec 

Field 

# 

Name 

Type 

Units 

Optiona 

1 

Interpretation 

1 

<bit_field> 

FollowerJD 

unsigned  integer 

bit_field 

false 

Bits  0..7  : 
Component  ID  of 
Leader 

Bits  8.. 15  :  Node 

ID  of  Leader 

Bits  16. .31  : 
Subsystem  ID  of 
Leader 

3. 1. 3.2.2  ID  FFD5:  RegisterFollowerResponse 

This  message  is  sent  as  a  response  to  a  register  request,  or  may  be  sent  asynchronously  if  the 
follower  does  not  periodically  resend  a  register  request.  The  required  periodic  rate  is  specified 
in  this  message. 

Table  3.1-7:  REGISTER  FOLLOWER  RESPONSE  MESSAGE  ENCODING 


body 

•—  record  name  =  FollowerRec 

Record 

Name  =  FollowerRec 

Field 

# 

Name 

Type 

Units 

Optiona 

1 

Interpretation 

1 

<fixed_field> 

Result 

unsigned  byte 

false 

Enum  0: 
CONNECTED 

Enum  1: 

DISCONNECTED 

2 

<fixed_field> 

Timeout 

unsigned  byte 

seconds 

false 

The  follower  must 
resend  a  Register 
request  before  the 
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timeout  elapses; 
otherwise,  the 
leader  may 
consider  the 
follower  as  having 
disconnected. 

3.1.4  Protocol  Behavior 


transport.Receivinq 


events.  Ready 


default 

L _ j 

i 

Figure  3.1-2:  LEADER  MANAGEMENT  SERVICE  PROTOCOL  BEHAVIOR 


Table  3.1-8:  LEADER  MANAGEMENT  SERVICE  STATE  TRANSITION  TABLE 


Label 

Trigger 

Conditions 

Actions 

QueryFollowers 

SendResponse  ( ‘ReportFollowers’ ) 

A 

RegisterFollower 

AddFollowerT  oRegistrationList 
SendResponse( 
‘RegisterFollowerResponse’, 
CONNECTED ) 

RequestSpeedOverride 

isRegistered 

setOverride  (  msg  ) 

Registration  Timeout 

SendResponse( 
‘RegisterFollowerResponse’, 
DISCONNECTED  ) 
RemoveFollowerToRegistrationList 

Table  3.1-9:  LEADER  MANAGEMENT  SERVICE  CONDITIONS 


Condition 

Interpretation 

isRegistered 

T rue  if  the  component  that  sent  the  message  is  in  the 
registered  follower  list 

Table  3.1-10:  LEADER  MANAGEMENT  SERVICE  TRANSITION  ACTIONS 


Action 

Interpretation 

SendResponse 

Send  the  specified  response  message 
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AddFollowerToRegistrationList 

Add  the  component  that  sent  the  request  to 
the  follower  list 

RemoveFollowerToRegistrationList 

Remove  the  component  from  the  follower 
list 

setOverhde 

Update  the  leader’s  override  value  based 
on  the  new  request.  The  current  override 
is  the  minimum  requested  value  of  all 
registered  followers. 

3.2  Leader  Follower  Driver 

name=  LeaderFollowerDriver 

version=0.1 

id=urn:jpo:autonomy:LeaderFollowerD  river 

Inherits-from  Management 
name=management 
id=  urn:jaus:jss:core:  Management 
version=1.0 


c<Transport»  ^ 


«Events» 


«AccessControl» 


cManagement»  ^ 


«Leader  Follower 
Driver» 


Figure  3.2-1:  LEADER  FOLLOWER  DRIVER  SERVICE 


3.2.1  Description 

The  Leader  Follower  Driver  Service  provides  a  mechanism  for  following  the  path  of  a  leader.  A 
leader  can  be  identified  by  the  ID  of  its  Global  Pose  Sensor  Service,  or  may  be  implicitly  known 
by  the  implementation.  In  addition,  a  leader  may  host  the  Leader  Management  Service,  which 


8 


Unclassified 


allows  a  follower  vehicle  to  adjust  the  speed  of  the  lead  vehicle  to  compensate  for  delays 
encountered,  such  as  local  obstacles,  traffic  conditions,  etc. 

3.2.2  Assumptions 

Messages  may  be  delayed,  lost  or  reordered. 

3.2.3  Vocabulary 

Table  3.2-1:  LEADER  FOLLOWER  DRIVER  SERVICE  VOCABULARY 


Message  ID 
(hex) 

Name 

Command 

Input  Set 

FFF3 

QuervFollowerConfiguration 

false 

FFF2 

SetFollowerConfiquration 

true 

FFF1 

SetFollowerState 

true 

Output  Set 

FFF4 

ReoortFollowerConfiquration 

false 

3.2.4  Encoding 

3.2.4.1  Input  Set 

3.2.4. 1. 1  ID  FFF3:  QueryFollowerConfiguration 

Queries  the  current  state  and  configuration  of  a  follower. 


Table  3.2-2:  QUERY  FOLLOWER  CONFIGURATION  MESSAGE  ENCODING 

body 

^  (empty) 


Empty  message  body 


3.2.4. 1.2  ID  FFF2:  SetFollowerConfiguration 

This  message  sets  the  configuration  for  the  follower.  The  leader  is  specified  by  an  optional 
JAUS  identifier  that  refers  to  a  Global  Pose  Sensor  Service  hosted  by  the  leader;  if  this  JAUS 
identifier  is  not  specified,  the  leader  is  assumed  to  be  known  a  priori  by  the  service.  The  optional 
offset  values  specify  the  follow  behavior  such  that  MinimumFollowDistance  and 
MaximumFollowDistance  represents  the  safe  operating  range  along  the  path  and  LagTime 
represents  the  delay,  in  seconds,  that  the  follower  should  maintain  from  the  leader.  Additional 
values  allow  for  more  complex  convoy  configurations  and  are  defined  with  respect  to  the  path  of 
the  lead  vehicle;  the  LateralOffset  refers  to  the  distance  from  the  path  in  the  ground  plane,  while 
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VerticalOffset  refers  to  the  height  above  or  below  the  path  measured  tangentially  to  the  ground 
plane.  Alternatively,  the  VerticalOffset  value  can  be  an  absolute  measure  of  the  desired  altitude 
with  respect  to  Mean  Sea  Level  (MSL),  the  Ground  Level  (AGL),  or  the  Sea  Floor  (ASL).  When 
not  explicitly  specified  in  the  message,  the  offset  values  are  assumed  to  be  equal  to  the  relative 
position  of  the  follower  with  respect  to  the  leader  at  the  time  the  SetFollowerState(  'START' )  is 
received.  Any  specified  offset  values  that  cannot  be  satisfied  due  to  physical  constraints,  such 
as  Z-offset  in  a  ground  system  or  orientation  in  a  fixed  wing  aircraft,  shall  be  ignored.  This 
message  may  also  contain  optional  maximum  error  values  for  each  offset  dimension.  When  the 
follower  error  exceeds  these  bounds,  the  follower  should  stop  and  may  also  stop  the  lead 
vehicle  if  the  appropriate  flag  is  set  in  the  ErrorBehavior  bitfield.  If  the 
ALLOW_LEADER_OVERRIDE  bit  is  set,  the  follower  may  attempt  to  slow  down  or  speed  up  the 
lead  vehicle  prior  to  exceeding  the  error  bounds.  If  the  error  values  are  not  specified  in  the 
message,  they  are  assumed  to  be  infinite. 

Table  3.2-3;  SET  FOLLOWER  CONFIGURATION  MESSAGE  ENCODING 


body 

record  name  =  FollowerRec 

Record 

I  Name  =  FollowerRec 

Field 

# 

Name 

Type 

Units 

Optiona 

I 

Interpretation 

1 

<  p  rese  n  ce_vecto  r> 

unsigned  short  integer 

2 

<bit_field> 

Leader_ID 

unsigned  integer 

bit_field 

true 

Bits  0..7  : 
Component  ID  of 
Leader 

Bits  8.. 15  :  Node 

ID  of  Leader 

Bits  16. .31  : 
Subsystem  ID  of 
Leader 

3 

<bit_field> 

ErrorBehavior 

unsigned  byte 

one 

true 

BitO: 

STOP  LEADER 

Bit  1: 

ALLOW  LEADER 
_OVERRIDE 

4 

<fixed_field> 

LagTime 

unsigned  integer 

Second 

true 

(scaled  range  = 
[0,3600],  round  ) 

5 

<fixed_field> 

MinimumFollowDistanc 

e 

unsigned  integer 

meter 

true 

(scaled  range  = 
[0,100000],  round  ) 

6 

<fixed_field> 

MaximumFollowDistan 

ce 

unsigned  integer 

meter 

true 

(scaled  range  = 
[0,100000],  round  ) 

7 

<fixed_field> 

LateralOffset 

unsigned  integer 

meter 

true 

(scaled  range  =  [- 
100000,100000], 
round  ) 
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8 

<fixed_field> 

MaxLateralError 

unsigned  integer 

meter 

true 

(scaled  range  = 
[0,100000],  round  ) 

9 

<fixed_field> 

VerticalOffset 

unsigned  integer 

meter 

true 

(scaled  range  =  [- 
100000,100000], 
round  ) 

10 

<fixed_field> 

MaxVerticalError 

unsigned  integer 

meter 

true 

(scaled  range  = 
[0,100000],  round  ) 

11 

<fixed_field> 

VerticalOffsetT  ype 

unsigned  byte 

one 

true 

Value  set, 

offset=false, 

ranges/enums: 

0=  DEPTH  MSL 

1=  DEPTH  AGL 

2=  DEPTH  ASF 

3=  RELATIVE 

12 

<fixed  field> 

Roll 

unsigned  short  integer 

radian 

true 

(scaled  range  =  [- 
PI, PI],  round  ) 

13 

<fixed_field> 

Max_Roll_Error 

unsigned  short  integer 

radian 

true 

(scaled  range  = 
[0,2*PI],  round  ) 

14 

<fixed_field> 

Pitch 

unsigned  short  integer 

radian 

true 

(scaled  range  =  [- 
PI, PI],  round  ) 

15 

<fixed_field> 

Max_Pitch_Error 

unsigned  short  integer 

radian 

true 

(scaled  range  = 
[0,2*PI],  round  ) 

16 

<fixed_field> 

Heading 

unsigned  short  integer 

radian 

true 

(scaled  range  =  [- 
PI, PI],  round  ) 

17 

<fixed_field> 

Max_Heading_Error 

unsigned  short  integer 

radian 

true 

(scaled  range  = 
[0,2*PI],  round  ) 

3.2.4. 1.3  ID  FFF1 :  SetFollowerState 

This  message  allows  a  service  to  start  or  stop  following  behavior. 

Table  3.2-4:  SET  FOLLOWER  STATE  MESSAGE  ENCODING 


body 

*—  record  name  =  FollowerStateRec 

Record 

1  Name  =  FollowerStateRec 

Field 

# 

Name 

Type 

Units 

Optiona 

1 

Interpretation 

1 

<fixed_field> 

State 

unsigned  byte 

one 

false 

Value  set, 

offset=false, 

ranges/enums: 

0=  STOP 

1 =  START 
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3.2.4.2  Output  Set 

3.2.4.2. 1  ID  FFF4:  ReportFoUowerConfiguration 

Table  3.2-5;  REPORT  FOLLOWER  CONFIGURATION  MESSAGE  ENCODING 


body 

•—  sequence  name  =  FollowerSeq 

1—  record  name  =  FollowerStateRec 
' —  record  name  =  FollowerRec 

Record 

I  Name  =  FollowerStateRec 

Field 

# 

Name 

Type 

Units 

Options 

I 

Interpretation 

1 

<fixed_field> 

State 

unsigned  byte 

one 

false 

Value  set, 

offset=false, 

ranges/enums: 

0=  STOP 

1 =  START 

Record 

I  Name  =  FollowerRec 

Field 

# 

Name 

Type 

Units 

Options 

I 

Interpretation 

1 

<  p  rese  n  ce_vecto  r> 

unsigned  short  integer 

2 

<bit_field> 

Leader_ID 

unsigned  integer 

bit_field 

true 

Bits  0..7  : 
Component  ID  of 
Leader 

Bits  8.. 15  :  Node 
ID  of  Leader 

Bits  16. .31  : 
Subsystem  ID  of 
Leader 

3 

<bit_field> 

ErrorBehavior 

unsigned  byte 

one 

true 

BitO: 

STOP  LEADER 

Bit  1: 

ALLOW  LEADER 
_OVERRIDE 

4 

<fixed_field> 

LagTime 

unsigned  integer 

Second 

true 

(scaled  range  = 
[0,3600],  round  ) 

5 

<fixed_field> 

MinimumFollowDistanc 

e 

unsigned  integer 

meter 

true 

(scaled  range  = 
[0,100000],  round 
) 

6 

<fixed_field> 

MaximumFollowDistan 

ce 

unsigned  integer 

meter 

true 

(scaled  range  = 
[0,100000],  round 
) 

7 

<fixed_field> 

LateralOffset 

unsigned  integer 

meter 

true 

(scaled  range  =  [- 
100000,100000], 
round  ) 
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8 

<fixed_field> 

MaxLateralError 

unsigned  integer 

meter 

true 

(scaled  range  = 
[0,100000],  round 
) 

9 

<fixed_field> 

VerticalOffset 

unsigned  integer 

meter 

true 

(scaled  range  =  [- 
100000,100000], 
round  ) 

10 

<fixed_field> 

MaxVerticalError 

unsigned  integer 

meter 

true 

(scaled  range  = 
[0,100000],  round 
) 

11 

<fixed_field> 

VerticalOffsetT  ype 

unsigned  byte 

one 

true 

Value  set, 

offset=false, 

ranges/enums: 

0=  DEPTH  MSL 

1=  DEPTH  AGL 
2=  DEPTH  ASF 

3=  RELATIVE 

12 

<fixed  field> 

Roll 

unsigned  short  integer 

radian 

true 

(scaled  range  =  [- 
PI, PI],  round  ) 

13 

<fixed_field> 

Max_Roll_Error 

unsigned  short  integer 

radian 

true 

(scaled  range  = 
[0,2*PI],  round  ) 

14 

<fixed_field> 

Pitch 

unsigned  short  integer 

radian 

true 

(scaled  range  =  [- 
PI, PI],  round  ) 

15 

<fixed_field> 

Max_Pitch_Error 

unsigned  short  integer 

radian 

true 

(scaled  range  = 
[0,2*PI],  round  ) 

16 

<fixed_field> 

Heading 

unsigned  short  integer 

radian 

true 

(scaled  range  =  [- 
PI, PI],  round  ) 

17 

<fixed_field> 

Max_Heading_Error 

unsigned  short  integer 

radian 

true 

(scaled  range  = 
[0,2*PI],  round  ) 
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3.2.5  Protocol  Behavior 


accessCtrl  .Controlled 


Management.StatqB 
C 


Ready 

/exit=D 


default 


/ 


Figure  3.2-2:  LEADER  FOLLOWER  DRIVER  SERVICE  PROTOCOL  BEHAVIOR 

Table  3.2-6:  LEADER  FOLLOWER  DRIVER  SERVICE  EXIT  STATE  TRANSITIONS 


Label 

State 

Type 

Guard 

Actions 

D 

Ready 

Exit 

isErrorBehaviorLeaderSt 

op 

sendStopT  oLeader 
resetFollowerState 

Ready 

Exit 

resetFollowerState 

Table  3.2-7:  LEADER  FOLLOWER  DRIVER  SERVICE  STATE  TRANSITIONS 


Label 

Trigger 

Conditions 

Actions 

A 

QueryFollowerConfiguration 

SendResponse  message 
‘ReportFollowerConfigura 
tion’ 

B 

SetFollowerConfiguration 

isControllingClientO 

setFollowerValues  (  msg 
) 

C 

SetFollowerState 

isControllingClientO 

SetFollowerState  (  msg  ) 

Table  3.2-8:  LEADER  FOLLOWER  DRIVER  SERVICE  CONDITIONS 


Condition 

Interpretation 

isControllingClient 

True  is  the  command  message  was  received  from  the 
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client  currently  controlling  this  component 


Table  3.2-9:  LEADER  FOLLOWER  DRIVER  SERVICE  TRANSITION  ACTIONS 


Action 

Interpretation 

SendResponse 

Send  the  specified  response  message 

setFollowerValues 

Set  the  specified  configuration  values 

setFollowerState 

Set  the  specified  follower  state 

resetFollowerState 

Set  following  state  to  STOP 

sendStopT  oLeader 

Send  an  E-STOP  request  to  the  leader 

3.3  Communicator  Service 

name=Communicator 

version=0.1 

id=urn:jpo:comms:Communicator 

Inherits-from  AccessControl 
name=accessControl 
id=  urn:jaus:jss:core:AccessControl 
version=1.0 


«Transport» 


Figure  3.3-1:  COMMUNICATOR  SERVICE 
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3.3.1  Description 

The  Communicator  Service  provides  a  mechanism  for  run-time  configuration  and  monitoring  of  a 
communication  iink,  usuaiiy  a  radio. 

3.3.2  Assumptions 

Messages  may  be  deiayed,  iost  or  reordered.  Each  instance  of  the  communicator  service  corresponds  to 
a  singie  communication  iink.  Muitipie  communication  iinks  may  be  present  on  a  singie  subsystem. 

3.3.3  Vocabulary 

Table  3.3-1:  COMMUNICATOR  SERVICE  VOCABULARY 


Message  ID 
(hex) 

Name 

Command 

Input  Set 

2900 

QuervCommunicatorCapabiiitv 

faise 

2901 

QuervCommunicatorConfiquration 

faise 

2902 

QuervCommunicatorHeaith 

faise 

0901 

SetCommunicatorConfiquration 

true 

Output  Set 

4900 

ReportCommunicatorCapabiiitv 

faise 

4901 

ReportCommunicatorConfiquration 

faise 

4902 

ReportCommunicatorHeaith 

faise 

0902 

SetCommunicatorConfiqurationResponse 

faise 

Table  3.3-2:  COMMUNICATOR  SERVICE  INTERNAL  EVENT  SET 


Name 

Interpretation 

Validation  Timeout 

Occurs  when  communications  are  not 
re-established  after  a  configuration 
change 

CommsEstablished 

Occurs  when  communications  are 
successfully  re-established  after  a 
configuration  change 

3.3.4  Encoding 

3. 3.4.1  Input  Set 

3.3.4. 1. 1  ID  2900:  QueryCommunicatorCapabUity 

This  message  is  used  to  query  capabiiities  associated  with  the  communication  device. 
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Table  3.3-3:  QUERY  COMMUNICATOR  CAPABILITY  MESSAGE  ENCODING 

body 

^  (empty) 


3.3.4. 1.2  ID  2901:  QueryCommunicatorConfiguration 

This  message  is  used  to  query  the  current  configuration  associated  with  the  communication  device. 

Table  3.3-4:  QUERY  COMMUNICATOR  CONFIGURATION  MESSAGE  ENCODING 


body 

record  name  =  QueryCommunicatorConfigurationRec 

Record  Name  =  QueryCommunicatorConfigurationRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

PresenceVector 

unsigned  short  integer 

one 

faise 

3.3.4. 1.3  ID  2902:  QueryCommunicatorHealth 


This  message  is  used  to  query  the  current  heaith  and  status  associated  with  the  communication  device. 

Table  3.3-5:  QUERY  COMMUNICATOR  HEALTH  MESSGAE  ENCODING 


body 

*—  record  name  =  QueryCommunicatorHeaithRec 

Record  Name  =  QueryCommunicatorHeaithRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

PresenceVector 

unsigned  short  integer 

one 

faise 

3.3.4. 1.4  ID  0901:  SetCommunicatorConfiguration 

The  Set  Communicator  Configuration  message  aiiows  the  ciient  component  to  set  configuration  vaiues  for 
the  communication  device. 

Table  3.3-6:  SET  COMMUNICATOR  CONFIGURATION  MESSAGE  ENCODING 


body 

I —  sequence  name  =  SetCommunicatorConfigurationSeq 
record  name  =  SetCommunicatorConfigurationRec 
variant  name  =  TransmitPowerVariant 

record  name  =  ContinuousAdjustabieRec 
record  name  =  HighLowPowerRec 
record  name  =  AutomaticPowerControiRec 

Record  Name  =  SetCommunicatorConfigurationRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<presence_vector> 

unsigned  short  integer 

2 

<fixed_field> 

unsigned  byte 

one 

true 

Value  enum 
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TransmitterStatus 

0=  TransmitOFF 

1=  TransmitON 

2=  Standby 

3 

<fixed_field> 

ModeOfOperation 

unsigned  byte 

one 

true 

Value  enum 

0=  Point_to_Point 

1=  Multipoint 

4 

<bit_field> 

EncryptionMode 

Unsigned  byte 

One 

True 

Bit  0:  TransmitterMode. 
When  this  bit  is  high,  the 
transmitted  data  will  be 
encrypted  using  AES 

128. 

Bit  1-2:  ReceiverMode. 
The  following 
enumeration  shall  apply: 

Enum  0:  Receive 
encrypted  only 

Enum  1 :  Receive 
non-encrypted  only 

Enum  2:  Receive  both 

Bit  3:  Encryption  type. 
When  this  bit  is  high, 
bulk  (transec)  encryption 
is  used.  Othenwise, 
packet  (payload) 
encryption  is  used. 

5 

<variablejength_string> 

EncryptionKey 

Count_field  =  unsigned 
byte 

One 

True 

Public  key  for  AES  128 
encryption 

6 

<fixed_field> 

Channel 

unsigned  byte 

one 

true 

7 

<fixed_field> 

FrequencyBand 

Unsigned  byte 

One 

true 

Band  index  as  defined  by 
the  Report  Capabilities 
message. 

8 

<fixed_field> 

ModulationScheme 

unsigned  byte 

one 

true 

Enum  value: 

0:  Adaptive  Modulation 

1 :  2-QAM 

2:  2-PSK 

3:  2-FSK 

4:  4-QAM 

5:  4-PSK 

6:  4-FSK 

7:  8-QAM 

8:  8-PSK 

9:  8-FSK 

10:  16-QAM 

11:  16-PSK 

12:  16-FSK 

13:  32-QAM 

14:  32-PSK 

15:  32-FSK 

16:  64-QAM 

17:  64-PSK 

18:  64-FSK 

9 

<fixed_field> 

OccupiedBandwidth 

unsigned  integer 

Hertz 

true 

Range  of  0  to  100  Mhz 
scaled  range  = 
[0,100000000] 

Record  Name  =  ContinuousAdjustableRec 

Field  # 

Name 

Fype 

Units 

Optional 

Interpretation 

1 

<fixed_field>  i 

TransmitPower 

jnsigned  short  integer 

watt 

False 

scaled  range  =  [0,10] 
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Record  Name  =  HighLowPowerRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

TransmitPower 

unsigned  byte 

one 

Faise 

Enum  values: 

LOW  POWER 
HIGH_POWER 

Record  Name  =  AutomaticPowerControiRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

MinTransmitPower 

unsigned  short  integer 

watt 

False 

scaled  range  =  [0,10] 

2 

<fixed_field> 

MaxT  ransmitPower 

unsigned  short  integer 

watt 

False 

scaled  range  =  [0,10] 

3. 3.4.2  Output  Set 

3.3.4.2. 1  ID  4900:  ReportCommunicatorCapability 

This  message  is  used  to  report  the  capabiiities  associated  with  this  communication  device. 

Table  3.3-7:  REPORT  COMMUNICATOR  CAPABILITY  MESSAGE  ENCODING 


body 

1 —  sequence  name  =  ReportCommunicatorCapabiiitiesSeq 
record  name  =  ReportCommunicatorCapabiiityRec 
list  name  =  FrequencyBandList 
(count_fie]d  =  unsigned  byte) 
record  name  =  FrequencyBandRec 
list  name  =  ChanneiList 

(count_fieid  =  unsigned  byte) 
record  name  =  ChanneiRec 

Record  Name  =  ReportCommunicatorCapabiiityRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<presence_vector> 

unsigned  short 
integer 

2 

<bit_field> 

SupportedTransmitterStatus 

unsigned  byte 

bit_fieid 

true 

For  each  bit,  a  value  of 
zero  means  the  status  is 
not  supported  by  the 
comms  device. 

Bit  0:  Transmit  ON 

Bit  1:  Transmit  OFF 

Bit  2:  Standby 

3 

<bit_field> 

SupportedModesOfOperation 

unsigned  byte 

bit_fieid 

true 

For  each  bit,  a  value  of 
zero  means  the  mode  is 
not  supported  by  the 
comms  device. 

Bit  0:  Point  to  Point 

Bit  1:  Multipoint 

4 

<bit_field> 

SupportedEncryptionModes 

Unsigned  byte 

One 

True 

For  each  bit,  a  value  of 
zero  means  the  mode  is 
not  supported  by  the 
comms  device. 

Bit  0:  Transmitter 
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supports  AES  128 
encryption. 

Bit  1 :  Receiver  supports 
encypted-only  mode 

Bit  2:  Receiver  supports 
non-encrypted  only 

Bit  3:  Receiver  supports 
promiscuous  mode 

Bit  4:  Bulk/Packet  mode. 

If  this  bit  is  set, 
encryption  is  bulk 
(transec).  Othenwise, 
encryption  is  packet 
(payload). 

5 

<fixed_field> 

MinTransmitPower 

unsigned  short 
integer 

watt 

true 

scaled  range  =  [0,10] 

6 

<fixed_field> 

MaxT  ransmitPower 

unsigned  short 
integer 

watt 

true 

scaled  range  =  [0,10] 

7 

<bit_field> 

SupportedTransmitPowerLevels 

Unsigned  byte 

One 

True 

For  each  bit,  a  value  of 
zero  means  the  power 
level  is  not  supported  by 
the  comms  device. 

Bit  0:  Continuous  Scale 
Adjustable 

Bit  1 :  Low  Power 

Bit  2:  High  Power 

Bit  3:  Automatic  Transmit 
Power  Control 

8 

<bit_field> 

SupportedModulationSchemes 

unsigned  integer 

one 

true 

For  each  bit,  a  value  of 
zero  means  the 
modulation  scheme  is 
not  supported: 

Bit  0:  Adaptive 

Modulation 

Bit  1 :  2-QAM 

Bit  2:  2-PSK 

Bit  3:  2-FSK 

Bit  4:  4-QAM 

Bit  5:  4-PSK 

Bit  6:  4-FSK 

Bit  7:  8-QAM 

Bit  8:  8-PSK 

Bit  9:  8-FSK 

Bit  10:  16-QAM 

Bit  11:  16-PSK 

Bit  12:  16-FSK 

Bit  13:  32-QAM 

Bit  14:  32-PSK 

Bit  15:  32-FSK 

Bit  16:  64-QAM 

Bit  17:  64-PSK 

Bit  18:  64-FSK 

9 

<fixed_field> 

MinimumOccupiedBandwidth 

unsigned  integer 

Hertz 

true 

Range  of  0  to  100  Mhz 
scaled  range  = 
[0,100000000] 

10 

<fixed_field> 

MaximumOccupiedBandwidth 

unsigned  integer 

Hertz 

true 

Range  of  0  to  100  Mhz 
scaled  range  = 
[0,100000000] 

Record  Name  =  FrequencyBandList 

1 

<fixed_field> 

unsigned  byte 

one 

faise 

Defines  a  band  for  multi- 
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Bandindex 

band  radios.  Each  band 
is  defined  in  the  range  of 
[Min,  Max], 

2 

<fixed_field> 

MinFrequency 

unsigned  iong 
integer 

Hertz 

faise 

Range  of  100  kHz  to  10 
GHz 

scaled  range  = 
[100000,10000000000] 

3 

<fixed_field> 

MaxFrequency 

unsigned  iong 
integer 

Hertz 

faise 

Range  of  100  kHz  to  10 
GHz 

scaled  range  = 
[100000,10000000000] 

Record  Name  =  ChanneiRec 

1 

<fixed_field> 

ChanneiNumber 

unsigned  byte 

one 

faise 

For  multi-band  radios, 
channel  numbers  may  be 
repeated,  but  each 
duplicate  channel 
number  must  have  a 
unique  band  index. 

2 

<fixed_field> 

CenterFrequency 

unsigned  iong 
integer 

Hertz 

faise 

Range  of  100  kHz  to  10 
GHz 

scaled  range  = 
[100000,10000000000] 

3 

<fixed_field> 

FrequencyBand 

Unsigned  byte 

One 

faise 

Band  index 

3.3.4.2.2  ID  4901:  ReportCommunicatorConfiguration 

This  message  is  used  to  report  the  current  configuration  associated  with  this  communication  device. 

Table  3.3-8:  REPORT  COMMUNICATOR  CONFIGURATION  MESSAGE  ENCODING 


body 

1 —  sequence  name  =  ReportCommunicatorConfigurationSeq 
record  name  =  ReportCommunicatorConfigurationRec 
variant  name  =  TransmitPowerVariant 

record  name  =  ContinuousAdjustabieRec 
record  name  =  HighLowPowerRec 
record  name  =  AutomaticPowerControiRec 

Record  Name  =  ReportCommunicatorConfigurationRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<presence_vector> 

unsigned  short  integer 

2 

<fixed_field> 

TransmitterStatus 

unsigned  byte 

one 

true 

Value  enum 

0=  TransmitOFF 

1=  TransmitON 

2=  Standby 

3 

<fixed_field> 

ModeOfOperation 

unsigned  byte 

one 

true 

Value  enum 

0=  Point_to_Point 

1=  Multipoint 

4 

<bit_field> 

EncryptionMode 

Unsigned  byte 

One 

True 

Bit  0:  TransmitterMode. 
When  this  bit  is  high,  the 
transmitted  data  will  be 
encrypted  using  AES  128. 

Bit  1-2:  ReceiverMode. 
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The  following  enumeration 
shall  apply: 

Enum  0:  Receive 
encrypted  only 

Enum  1 :  Receive  non- 
encrypted  only 

Enum  2:  Receive  both 

Bit  3:  Encryption  type. 
When  this  bit  is  high,  bulk 
(transec)  encryption  is 
used.  Othenwise,  packet 
(payload)  encryption  is 
used. 

5 

<fixed_field> 

Channel 

unsigned  byte 

one 

true 

6 

<fixed_field> 

FrequencyBand 

Unsigned  byte 

One 

true 

Band  index  as  defined  by 
the  Report  Capabilities 
message. 

7 

<bit_field> 

ActiveModulationScheme 

unsigned  byte 

one 

true 

Bit  0:  Adaptive  Modulation 
Active  (when  this  bit  is  set, 
adaptive  modulation  is 
active.  The  instantaneous 
modulation  type  is  given 
by  bits  1-7). 

Bits  1-7:  Current 
(instantaneous) 
modulation  type  based  on 
the  following  enumeration: 

1 :  2-QAM 

2:  2-PSK 

3:  2-FSK 

4:  4-QAM 

5:  4-PSK 

6:  4-FSK 

7:  8-QAM 

8:  8-PSK 

9:  8-FSK 

10:  16-QAM 

11:  16-PSK 

12:  16-FSK 

13:  32-QAM 

14:  32-PSK 

15:  32-FSK 

16:  64-QAM 

17:  64-PSK 

18:  64-FSK 

8 

<fixed_field> 

OccupiedBandwidth 

unsigned  integer 

Hertz 

true 

Range  of  0  to  100  Mhz 
scaled  range  = 
[0,100000000] 

Record  Name  =  ContinuousAdjustableRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

TransmitPower 

unsigned  short  integer 

watt 

False 

scaled  range  =  [0,10] 

Record  Name  =  HighLowPowerRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

TransmitPower 

unsigned  byte 

one 

False 

Enum  values: 

LOW  POWER 
HIGH_POWER 
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Record  Name  =  AutomaticPowerControiRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

MinTransmitPower 

unsigned  short  integer 

watt 

False 

scaled  range  =  [0,10] 

2 

<fixed_field> 

MaxT  ransmitPower 

unsigned  short  integer 

watt 

False 

scaled  range  =  [0,10] 

3.3.4.2.3  ID  4902:  ReportCommunicatorHealth 


This  message  is  used  to  report  the  current  heaith  and  status  associated  with  this  communication  device. 

Table  3.3-9:  REPORT  COMMUNICATOR  HEALTH  MESSAGE  ENCODING 


body 

I —  sequence  name  =  ReportCommunicatorHeaithSeq 
record  name  =  ReportCommunicatorHeaithRec 
variant  name  =  ErrorVariant 

record  name  =  PacketErrorCountRec 
record  name  =  PacketErrorRateRec 
record  name  =  BitErrorCountRec 
record  name  =  BitErrorRateRec 
list  name  =  ChanneiList 

(count_fieid  =  unsigned  byte) 
record  name  =  ChanneiRec 

Record  Name  =  ReportCommunicatorHeaithRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<presence_vector> 

unsigned  byte 

2 

<fixed_field> 

BITResuits 

unsigned  byte 

one 

true 

Enumeration  values: 

0=  Passed 

1=  Failed 

3 

<fixed_field> 

Latency 

unsigned  short  integer 

second 

true 

scaled  range  =  [0,1] 

4 

<fixed_field> 

DataRate 

unsigned  short  integer 

one 

true 

Measured  in  Mbps 
scaled  range  =  [0,1000] 

5 

<fixed_field> 

ReceivedSignaiPower 

unsigned  short  integer 

one 

true 

Measured  in  dBm 
scaled  range  =  [-120,-20] 

6 

<fixed_field> 

ErrorVectorMagnitude 

unsigned  short  integer 

one 

true 

Percent 

scaled  range  =  [0,100] 

Record  Name  =  PacketErrorCountRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

PacketErrorCount 

Unsigned  integer 

one 

faise 

Number  of  packet  errors  in 
the  last  one  second 

Record  Name  =  PacketErrorRateRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

PacketErrorRate 

Unsigned  integer 

one 

faise 

Packet  errors  as  a 
percentage  of  total 
packets  sent 

Scale  range  =  [0,  100] 

Record  Name  =  BitErrorCountRec 
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Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

BitErrorCount 

Unsigned  integer 

one 

false 

Number  of  bit  errors  in  the 
last  one  second 

Record  Name  =  BitErrorRateRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

BitErrorRate 

Unsigned  integer 

one 

false 

Bit  errors  as  a  percentage 
of  total  bits  sent 

Scale  range  =  [0,  100] 

Record  Name  =  SNR  Per  Channei  Rec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

Channel 

unsigned  byte 

one 

false 

2 

<fixed  field> 

SNR 

unsigned  short  integer 

one 

false 

scaled  range  =  [0,100] 

3.3.4.2.4  ID  0902:  SetCommunicatorConfigurationResponse 

The  Set  Communicator  Configuration  Response  message  is  sent  as  a  notification  back  to  a  ciient  on  the 
status  of  the  SetCommunicatorConfiguration  message. 

Table  3.3-10:  SET  COMMUNICATOR  CONFIGURATION  RESPONSE  MESSAGE  ENCODING 


body 

record  name  =  SetCommunicatorConfigurationResponseRec 

Record  Name  =  SetCommunicatorConfigurationResponseRec 

Field  # 

Name 

Type 

Units 

Option 

al 

Interpretation 

<bit_field> 

Result 

unsigned  byte 

bit_field 

false 

For  each  bit,  a  value  of  1  means 
the  command  value  was  invalid 

Bit  0:  TransmitterStatusInvalid 

Bit  1:  Modeinvalid 

Bit  2:  Channelinvalid 

Bit  3:  PowerLevelInvalid 

Bit  4:  Modulationinvalid 

Bit  5:  Bandwidthinvalid 

Bit  6:  EncryptionModeInvalid 

3.3.5  Protocol  Behavior 

The  Communicator  uses  a  ‘safety  valve’  mechanism  to  provide  fault-tolerant  changes  to 
configuration;  when  a  configuration  change  is  requested,  communications  must  be  re¬ 
established  within  a  specified  period  of  time  or  the  previous  configuration  is  restored  (reverted). 
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Figure  3.3-2:  COMMUNICATOR  SERVICE  PROTOCOL  BEHAVIOR 
Table  3.3-11:  COMMUNICATOR  SERVICE  STATE  TRANSITIONS 


Label 

Trigger 

Conditions 

Actions 

QueryCommunicatorCapability 

SendResponse  message 

‘ReportCommunicatorCapa 

bility’ 

A 

QueryCommunicatorConfiguration 

SendResponse  message 

‘ReportCommunicatorConfig 

uration’ 

QueryCommunicatorHealth 

SendResponse  message 
‘ReportCommunicatorHealth 

B 

SetCommunicatorConfiguration 

isControllingClientO  &&  ! 
isValidCommandO 

SendResponse  message 

‘SetCommunicatorRespons 

e’ 

c 

SetCommunicatorConfiguration 

isControllingClientO  && 
IsValidCommandO 

storeCurrentConfigurationV 

aluesO 

setConfigurationValues  ( 
msg  ) 

SendResponse  message 
‘SetCommunicatorRespons 
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e’ 

QueryCommunicatorCapability 

isControllingClientO 

SendResponse  message 

‘ReportCommunicatorCapa 

bility’ 

D 

QueryCommunicatorConfiguration 

isControllingClientO 

SendResponse  message 

‘ReportCommunicatorConfig 

uration’ 

QueryCommunicatorHealth 

isControllingClientO 

SendResponse  message 
‘ReportCommunicatorHealth 

Validation  Timeout 

revertConfigurationValuesO 

CommsEstablished 

Table  3.3-12:  COMMUNICATOR  SERVICE  CONDITIONS 


Condition 

Interpretation 

isValidCommand 

True  if  all  command  values  specified  in  the  message  are  valid 

isControllingClient 

True  is  the  command  message  was  received  from  the  client 
currently  controlling  this  component 

Table  3.3-13:  COMMUNICATOR  SERVICE  TRANSITION  ACTIONS 


Action 

interpretation 

SendResponse 

Send  the  specified  response  message 

SetConfigurationValues 

Set  the  specified  configuration  values 

storeCurrentConfigurationValues 

Store  the  current  configuration  values  prior  to  setting 
the  new  values,  in  case  the  configuration  needs  to  be 
reverted 

revertConfigurationValues 

Revert  to  the  previously  stored  configuration 

3.4  Platform  Mode  Service 

name=PlatformMode 

version=0.1 

id=urn:jpo:platformmanager:PlatformMode 

Inherits-from  AccessControl 
name=AccessControl 
id=  urn:jaus:jss:core:AccessControl 
version=1 .0 
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«Transport» 


«Events» 


«AccessControl» 


«Platform  Mode» 


Figure  3.4-1:  PLATFORM  MODE  SERVICE 

3.4.1  Description 

The  Platform  Mode  Service  provides  a  mechanism  for  informing  of  a  mode  change. 

3.4.2  Assumptions 

Messages  may  be  delayed,  lost  or  reordered. 

3.4.3  Vocabulary 

Table  3.4-1:  PLATFORM  MODE  SERVICE  VOCABULARY 


Message  ID 
(hex) 

Name 

Command 

Input  Set 

FF20 

QueryPlatformMode 

false 

FF21 

Query  A  vailableModes 

false 

FF22 

SetPlatformMode 

true 

Output  Set 

FF23 

ReportPlatformMode 

false 

FF24 

Report  A  vailableModes 

false 

3.4.4  Encoding 

3.4.4.1  Input  Set 

3.4.4. 1. 1  ID  FF20  QueryPlatformMode 

This  message  is  used  to  query  the  current  piatform  mode. 
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Table  3.4-2:  QUERY  PLATFORM  MODE  MESSAGE  ENCODING 

body 

^  (empty) 


3.4.4. 1.2  ID  FF21  QueryAvailableModes 

This  message  is  used  to  query  the  supported  avaiiabie  modes. 


Table  3.4-3:  QUERY  AVAILABLE  MODES  MESSAGE  ENCODING 

body 

^  (empty) 


3.4.4. 1.3  ID  FF22  SetPlatformMode 

This  message  is  used  to  set  the  current  piatform  mode  of  a  component. 

Table  3.4-4:  SET  PLATFORM  MODE  MESSAGE  ENCODING 


body 

1 —  record  name  =  SetPiatformModeRec 

Record  Name  =  SetPiatformModeRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

Mode 

unsigned  byte 

one 

faise 

Enumerated  Values 

0  =  Operational 

2 

<fixed_field> 

DriveSubMode 

unsigned  byte 

One 

Faise 

Enumerated  values 

0  =  RC  Teleop 

1  =  Waypoint  Navigation 

2  =  Leader  Follower 

3.4.4.2  Output  Set 

3.4.4.2. 1  ID  FF23:  ReportPlatformMode 

This  message  is  used  to  report  the  current  piatform  mode. 


Table  3.4-5:  REPORT  PLATFORM  MODE  MESSAGE  ENCODING 


body 

L 


record  name  =  ReportPiatformModeRec 
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Record  Name  =  ReportPlatformModeRec 


Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

Mode 

unsigned  byte 

one 

faise 

Enumerated  Values 

0  =  None 

1  =  Operational 

2 

<fixed_field> 

DriveSubMode 

unsigned  byte 

One 

faise 

Enumerated  values 

0  =  RC  Teleop 

1  =  Waypoint  Navigation 

2  =  Leader  Follower 

3.4.4.2.2  ID  FF24:  ReportAvailableModes 

This  message  is  used  to  report  the  supported  modes. 


Table  3.4-6:  REPORT  AVAILABLE  MODES  MESSAGE  ENCODING 


body 

I —  list  name  =  ModeList 

(count_fieid  =  unsigned  byte) 
record  name  =  ModeRec 

Record  Name  =  ModeRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

Mode 

unsigned  byte 

one 

faise 

Enumerated  Values 

0  =  Operational 

2 

<bit_field> 

DriveSubModes 

unsigned  byte 

bit_fieid 

faise 

For  each  bit,  a  value  of  1  means  the  mode  is 
available 

Bit  0:  RC  Teleop 

Bit  1:  Waypoint  Navigation 

Bit  2:  Leader  Follower 
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3.4.5  Protocol  Behavior 


transport.Receiving 


events.  Ready 


z 


accessCtrl.NotControlled 


Default 


A 


accessCtrl. Controlled 


A,  B 


Figure  3.4-2:  PLATFORM  MODE  SERVICE  PROTOCOL  BEHAVIOR 


Table  3.4-7:  PLATFORM  MODE  SERVICE  STATE  TRANSITIONS 


Label 

Trigger 

Conditions 

Actions 

A 

QueryPlatformMode 

SendResponse  message 
‘ReportPlatformMode’ 

QueryAvailableModes 

SendResponse  message 
‘ReportAvailableModes’ 

B 

SetPlatformMode 

isControllingClientO 

setPlatformMode(  msg  ) 

SendResponse 

‘ReportPlatformMode’ 

Table  3.4-8:  PLATFORM  MODE  SERVICE  CONDITIONS 


Condition 

Interpretation 

isControllingClient 

True  if  the  command  message  was  received  from  the  client 
currently  controlling  this  component 

Table  3.4-9:  PLATFORM  MODE  SERVICE  TRANSITION  ACTIONS 


Action 

Interpretation 

SendResponse 

Send  the  specified  response  message 

3.5  Health  Monitor  Service 

Name=HealthMonitor 
Version  =  0.1 

ld=urn:jpo:health:HealthMonitor 
Inherits-from:  urn:jaus:jss:core:Events,  vl.O 
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Figure  3.5-1:  HEALTH  MONITOR  SERVICE 


3.5.1  Description 

The  Health  Monitor  service  indicates  components  and/or  services  that  are  in  an  emergency, 
failure,  degraded,  or  comms  lost  state. 

3.5.2  Assumptions 

Messages  may  be  delayed,  lost,  or  reordered. 


3.5.3  Vocabulary 

Table  3.5-1:  HEALTH  MONITOR  SERVICE  VOCABULARY 


Message  ID 
(hex) 

Name 

Command 

Input  Set 

FF10 

QueryComponentHealth 

False 

FF11 

QueryServIceHealth 

false 

Output  Set 

FF12 

ReportComponentHealth 

false 

FF13 

ReportServIceHealth 

false 

3.5.4  Encoding 

3. 5.4.1  Input  Message  Set 

3.5.4. 1. 1  ID  FF10:  QueryComponentHealth 

Allows  consumers  of  the  Health  Monitor  service  to  determine  what  components  residing  on  a  subsystem 
are  In  a  failure,  emergency,  degraded,  or  comms  lost  state.  This  message  shall  request  the  health  status 
summary  of  a  subsystem  or  node  or  a  single  component.  This  message  Is  closely  related  to  the  Query 
Service  List  message. 
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Table  3.5-2;  QUERY  COMPONENT  HEALTH  MESSAGE  ENCODING 


Body 

*-  list  name=SubsystemLlst 

(count_fleld  =  unsigned  short  Integer) 
sequence  name=SubsystemSeq 
record  name=SubsystemRec 
list  name=NodeLlst 

(count_fleld  =  unsigned  byte) 
sequence  name=NodeSeq 
record  name=NodeRec 
list  name  =  ComponentLIst 
(count_fleld  =  unsigned  byte) 
record  name  =  ComponentRec 

record  name=SubsystemRec 

Field# 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

Subsystem  ID 

unsigned 
short  Integer 

one 

false 

Use  65535  (OxFFFF)  if  health  status  information 
from  all  subsystems  in  the  system  is  required.  If  0 
is  used,  then  the  health  status  applies  to  the 
parent  subsystem  of  the  Health  Monitor  service. 

Value_range 

0:  Health  status  for  parent  subsystem. 

1-65534:  valid  Subsystem  IDs 

65535:  All  subsystems  in  the  system. 

record  name=NodeRec 

1 

<fixed  field> 

Node  ID 

unsigned 

byte 

one 

false 

Use  255  if  health  status  information  from  all  nodes 
in  the  subsystem  is  required. 

Value_range 

0:  Reserved 

1-254:  valid  Node  IDs 

255:  All  nodes  in  the  subsystem 

record  name=ComponentRec 

1 

<fixed_field> 

Component  ID 

unsigned 

byte 

one 

false 

Use  255  health  status  information  from  all 
components  in  the  node  are  required. 

Value_range 

0:  Reserved 

1-254:  valid  component  IDs 

255:  All  components  in  the  node. 

3.5 A.  1.2  ID  FF1 1 :  QueryServiceHealth 

Allows  consumers  of  the  Health  Monitor  service  to  get  a  full  list  of  what  services  are  reporting  errors  or 
other  significant  health  Issues.  This  message  request  the  health  status  for  services  based  on  subsystem, 
node,  component,  and  an  optional  search  filter. 


Table  3.5-3:  QUERY  SERVICE  HEALTH  MESSAGE  ENCODING 


Body 

L  list  name=SubsystemLlst 

(count_fleld  =  unsigned  short  Integer) 
sequence  name=SubsystemSeq 
record  name=SubsystemRec 
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list  name=NodeList 

(count_fieid  =  unsigned  byte) 
sequence  name=NodeSeq 
record  name=NodeRec 
list  name  =  ComponentList 
(count_fieid  =  unsigned  byte) 
record  name  =  ComponentRec 

record  name=SubsystemRec 

Field# 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

Subsystem  ID 

unsigned 
short  integer 

one 

faise 

Use  65535  (OxFFFF)  if  health  status  information 
from  all  subsystems  in  the  system  is  required.  If  0 
is  used,  then  the  health  status  applies  to  the 
parent  subsystem  of  the  Flealth  Monitor  service. 

Value_range 

0:  Flealth  status  for  parent  subsystem. 

1-65534:  valid  Node  IDs 

65535:  All  subsystems  in  the  system. 

record  name=NodeRec 

1 

<fixed  field> 

Node  ID 

unsigned 

byte 

one 

faise 

Use  255  if  health  status  information  from  all  nodes 
in  the  subsystem  is  required. 

Value_range 

0:  Reserved 

1-254:  valid  Node  IDs 

255:  All  nodes  in  the  subsystem 

record  name=ComponentRec 

1 

<presence_vector> 

Unsigned 

byte 

One 

Faise 

2 

<fixed_field> 

Component  ID 

unsigned 

byte 

one 

faise 

Use  255  health  status  information  from  all 
components  in  the  node  are  required. 

Value_range 

0:  Reserved 

1-254:  valid  component  IDs 

255:  All  components  in  the  node. 

3 

<variable_length_str 

ing> 

SearchFilter 

Count_fieid 
=  unsigned 
byte 

One 

True 

An  optional  filter  to  apply  to  the  search  results. 

Only  service  identifiers  that  contain  this  string 
should  be  returned. 

3. 5.4.2  Output  Message  Set 

3.5A.2. 1  ID  FF12:  ReportComponentHealth 

Returns  a  structure  containing  the  component  heaith  information  for  subsystem,  nodes,  and  components 
specified. 


Table  3.5-4;  REPORT  COMPONENT  HEALTH  MESSAGE  ENCODING 


body 

list  name  =  SubsystemList 

(count_fieid  =  unsigned  short  integer) 
sequence  name=SubsystemSeq 
record  name=SubsystemRec 
list  name  =  NodeList 
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(count_field  =  unsigned  byte) 

L  sequence  name  =  NodeSeq 
record  name  =  NodeRec 

L  list  name  =  ComponentList 
(count_field  =  unsigned  byte) 

L  record  name  =  ComponentHealthRec 

record  name=SubsystemRec 

Field# 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

SubsystemID 

Unsigned 
short  integer 

One 

False 

Subsystem  ID. 

record  name=NodeRec 

Field# 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed  field> 

NodelD 

Unsigned 

byte 

One 

False 

Node  ID. 

record  name=ComponentHealthRec 

1 

<fixed_field> 

ComponentID 

Unsigned 

integer 

One 

False 

Component  ID.  The  full  ID  of  the  component  that 
health  is  being  reported  for,  where  the  least 
significant  byte  is  the  component  ID,  the  next  least 
significant  byte  is  the  node  ID,  and  the  highest  two 
bytes  are  the  subsystem  ID. 

2 

<fixed_field> 

HealthState 

Unsigned 
short  integer 

One 

False 

0:  Failure 

1 :  Emergency 

2:  Degraded 

3:  Comms  Lost 

3 

<variable_length_str 

ing> 

HealthMessage 

Count_field= 

unsigned 

byte 

One 

False 

Descriptive  message  about  the  health  state. 

3.5.4.2.2  ID  FF13:  ReportServiceHealth 

Returns  a  list  of  ReportHealthRec  containing  the  component  ID,  health  state  enumeration,  and  descriptive 
string  of  all  the  components  on  the  subsystem  that  are  in  a  failure,  emergency,  degraded,  or  comms  lost 
state. 


Table  3.5-5:  REPORT  SERVICE  HEALTH  MESSAGE  ENCODING 


Body 

L  list  name  =  SubsystemList 

(count_field  =  unsigned  short  integer) 
sequence  name=SubsystemSeq 
record  name=SubsystemRec 
L  list  name  =  NodeList 

(count_field  =  unsigned  byte) 

L  sequence  name  =  NodeSeq 
L  record  name  =  NodeRec 
L  list  name  =  ComponentList 
(count_field  =  unsigned  byte) 

*-  sequence  name  =  ComponentSeq 
L  record  name  =  ComponentRec 
L  list  name  =  ServiceHealthList 
(count_field  =  unsigned  byte) 
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L  record  name  =  ServiceHealthStatusRec 

record  name=SubsystemRec 

Field# 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

SubsystemID 

Unsigned 
short  integer 

One 

Faise 

Subsystem  ID. 

record  name=NodeRec 

Field# 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed  field> 

NodelD 

Unsigned 

byte 

One 

Faise 

Node  ID. 

record  name=ComponentRec 

1 

<fixed_field> 

ComponentID 

Unsigned 

byte 

One 

Faise 

Component  ID. 

record  name=ServiceHealthStatusRec 

1 

<variable_length_str 

ing> 

Service_urn 

Count_fieid 
=  unsigned 
byte 

One 

Faise 

Urn  of  the  service  health  status  is  being  reported 
for. 

2 

<fixed_field> 

Severity 

Unsigned 

byte 

One 

Faise 

Value  set,  offset=false,  ranges/enums: 

0=NONE 

1=INFO 

2=WARN 

3=ERR 

4=FAIL 

[5.255]=<reserved> 

3 

<fixed_field> 

Code 

Unsigned 

byte 

One 

Faise 

Value  set,  offset=false,  ranges/enums: 

1=PROCESSOR 

2=RAM 

3=ROM 

4=FILESYS 

5=POWER 

6=SENSOR 

7=ACTUATOR 

8=SOFT 

[9,254]=RESERVED 

255=BUSY 

4 

<bit_field> 

Logtime 

Unsigned 

integer 

Bit_fieid 

Faise 

Bits  0..9,  Value  set,  offset=false,  ranges/enums:[0,999] 
Bits  10.. 15,  Value  set,  offset=false, 
ranges/enums:[0,59] 

Bits  16. .21,  Value  set,  offset=false, 
ranges/enums:[0,59] 

Bits  22.. 26,  Value  set,  offset=false, 
ranges/enums:[0:23] 

Bits  27.. 31, 

Value  set,  offset=false, 

Ranges/enums[1 ,31] 

5 

<variable_length_str 

ing> 

Descriptor 

Variabie 
iength  string 
(byte[]) 

N/A 

Faise 

(Length  min. .max  =  0..32) 
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3.5.5  Protocol  Behavior 


Figure  3.5-2:  HEALTH  MONITOR  SERVICE  PROTOCOL  BEHAVIOR 


Table  3.5-6:  HEALTH  MONITOR  SERVICE  STATE  TRANSITIONS 


Label 

Trigger 

Conditions 

Actions 

A 

QueryComponentHealth 

sendReportComponentHealth 

A 

QueryServiceHealth 

sendReportServiceHealth 

Table  3.5-7:  HEALTH  MONITOR  SERVICE  TRANSITION  ACTIONS 


Action 

Interpretation 

sendReportComponentHealth 

Sends  a  ReportComponentHealth  message  to  the 
requesting  client. 

sendReportServiceHealth 

Sends  a  ReportServiceHealth  message  to  the 
requesting  client. 

3.6  Health  Reporter  Service 

Name=HealthReporter 
Version  =  0.1 

ld=urn:jpo:health:HealthReporter 

Inherits-from:  urn:jaus:jss:core:AccessControl,  vl.O 
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Figure  3.6-1:  HEALTH  REPORTER  SERVICE 

3.6.1  Description 

The  Health  Reporter  attributes  defines  a  Health  Reporter  service  that  is  used  to  perform  built-in 
test  (BIT)  operations  at  Power-On  and  subsets  of  built-in-test  in  the  background  during  runtime 
(RBIT)  and  when  requested  via  command  message  (OBIT).  The  Health  Reporter  service 
maintains  a  record  of  the  most  current  BIT  results,  and  provides  the  most  current  BIT  results 
when  requested  by  a  client  or  configured  event. 

3.6.2  Assumptions 

Messages  may  be  delayed,  lost,  or  reordered. 

3.6.3  Vocabulary 

Table  3.6-1:  HEALTH  REPORTER  SERVICE  VOCABULARY 


Message  ID 
(hex) 

Name 

Command 

Input  Set 

ED01 

QueryHealthStatus 

False 

DD01 

PerformCBIT 

True 

Output  Set 

FD01 

ReportHealth  Status 

false 
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3.6.4  Encoding 

3. 6.4.1  Input  Message  Set 

3.6.4. 1. 1  ID  ED01:  QueryHealthStatus 

The  QueryHealthStatus  message  is  used  to  request  the  most  recent  status  from  the  Health 
Reporter. 


Table  3.6-2:  QUERY  HEALTH  STATUS  MESSAGE  ENCODING 


3.6.4. 1.2  ID  DD01:  PerformCBIT 

This  message  is  used  to  request  Health  Reporter  to  initiate  execution  of  Commanded  BIT 
(CBIT). 


3. 6.4.2  Output  Message  Set 

3. 6.4.2. 1  ID  FD0 1 :  ReportHealthStatus 

This  message  provides  a  report  of  the  most  recent  status.  The  Report  is  constituted  as  a  List,  so 
that  multiple  status  records  may  be  reported  in  a  single  message;  this  enables  a  module  to 
report  errors  from  multiple  services,  and  multiple  errors  per  service.  Errors  not  unique  to  a  given 
service  (as  some  hardware  test  failures)  are  reported  with  the  service_urn  of  the  Health 
Reporter  service. 

Table  3.6-4:  REPORT  HEALTH  STATUS  MESSAGE  ENCODING 


Body 

L  list  name  =  ComponentStatus 
(count_field  =  unsigned  byte) 
record  name=status 

record  name=Status 

Field# 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<variable_length_str 
ing  > 

service_urn 

Variabie 
iength  string 
(byte[]) 

One 

Faise 

(Length  min. .max  =  0..64) 

2 

<fixed_field> 

Severity 

Unsigned 

byte 

One 

Faise 

Value  set,  offset=false,  ranges/enums: 

0=  NONE 

1=  INFO 
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2=  WARN 

3=  ERR 

4=  FAIL 

[5.. 255]  =  <reserved> 

3 

<fixed_field> 

Code 

Unsigned 

byte 

One 

Faise 

Value  set,  offset=false,  ranges/enums: 

1=  PROCESSOR 

2=  RAM 

3=  ROM 

4=  FILESYS 

5=  POWER 

6= SENSOR 

7=  ACTUATOR 

8=  SOFT 

[9,254]  =  RESERVED 

255=  BUSY 

4 

<bit_field> 

Logtime 

Unsigned 

integer 

One 

Faise 

Bits  0..9,  Value  set,  offset=false,  ranges/enums:[0,999] 
Bits  10.. 15,  Value  set,  offset=false, 
ranges/enums:[0,59] 

Bits  16. .21,  Value  set,  offset=false, 
ranges/enums:[0,59] 

Bits  22.. 26,  Value  set,  offset=false. 

5 

<variable_length_str 

ing> 

Descriptor 

Variabie 
iength  string 
{byte[]) 

One 

Faise 

(Length  min. .max  =  0..32) 

3.6.5  Protocol  Behavior 


r 

accessCtrl.NotControlled 


A 

defaul; 

ik 

V 


(  accessCtrl. Controlled 


(  ^ 

default 

/ 

Figure  3.6-2:  HEALTH  REPORTER  SERVICE  PROTOCOL  BEHAVIOR 


39 


Unclassified 


Table  3.6-5:  HEALTH  REPORTER  SERVICE  STATE  TRANSITIONS 


Label 

Trigger 

Conditions 

Actions 

A 

QueryHealthStatus 

sendReportHealth  Status 

B 

PerformCBIT 

isControllingClient 

performCBIT 

Table  3.6-6:  HEALTH  REPORTER  SERVICE  TRANSITION  ACTIONS 


Action 

Interpretation 

sendReportHealthStatus 

Sends  a  ReportHealthStatus  message  to  the  requesting 
client. 

performCBIT 

Initiaties  a  Built  in  Test  on  the  node/component  receiving  the 
command  that  updates  the  health  status  that  is  reported  by 
subsequent  ReportHealthStatus  messages. 

3. 7  Digital  Stream  Discovery 

name=  DigitalStreamDiscovery 
version=0.1 

id=urn:jaus:iop:DigitalStreamDiscovery 

Inherits-from  Events 
name=events 

id=  urn:jaus:jss:core:Events 
version=1.0 


«Transport» 


«Events» 


«DigitalStreamDiscovery> 


Figure  3.7-1:  DIGITAL  STREAM  DISCOVERY  SERVICE 
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3.7.1  Description 

The  Digital  Stream  Discovery  Service  provides  a  mechanism  for  SAE  JAUS-based  components  to 
discovery  network  entities  that  transmit  digital  data  streams  (usually  video  and/or  audio)  in  a  standards- 
compliant  format.  Because  of  the  wide-spread  support  for  numerous  streaming  standards,  this  service 
does  not  propose  a  JAUS-specific  format  for  data;  it  only  provides  a  discovery  mechanism  based  on 
Uniform  Resource  Locator  (URL). 

3.7.2  Assumptions 

Messages  may  be  delayed,  lost  or  reordered. 

3.7.3  Vocabulary 

Table  3.7-1:  DIGITAL  STREAM  DISCOVERY  SERVICE  VOCABULARY 


Message  ID 
(hex) 

Name 

Command 

Input  Set 

E8A2 

QuervDiqitalStreamEndpoint 

False 

E8A3 

ReqisterDiqitalStreamEndpoint 

False 

Output  Set 

F8A2 

ReportDiqitalStreamEndpoint 

false 

3.7.4  Encoding 

3. 7.4.1  Input  Set 

3. 7.4. 1. 1  ID  E8A2:  QueryDigitalStreamEndpoint 

Queries  for  a  list  of  known  stream  source  endpoints. 


Table  3.7-2:  QUERY  DIGITAL  STREAM  ENDPOINT  MESSAGE  ENCODING 


body 

L  <empty> 


3. 7.4. 1.2  ID  E8A3:  RegisterDigitalStreamEndpoint 

Registers  a  stream  with  the  service,  or  removes  an  existing  stream.  Each  endpoint  is  represented  by  a 
URL;  however,  the  URL  shall  not  require  a  Domain  Name  Service  (DNS)  to  resolve.  In  addition,  each 
stream  may  also  specify  a  JAUS  ID  that  hosts  additional  SAE  JAUS  Services  for  the  configuration  and 
control  of  the  stream,  as  well  as  a  SensorlD  that  identifies  the  stream  source. 
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body 

I _  list  name  =  RegisterDigitalStreamEndpointList 

(count_field  =  unsigned  short  integer) 

sequence  name  =  RegisterDigitalStreamEndpointSeq 
record  name  =  RegistrationTypeRec 
record  name  =  EndpointCommonDataRec 

record  name  =  RegistrationTypeRec 

Field 

Name 

Type 

Units 

Optional? 

Interpretation 

1 

<fixed_field> 

RegistrationType 

Unsigned 

byte 

one 

False 

Value_enum: 

0  =  Register 

1  =  Unregister 

record  name  =  EndpointCommonDataRec 

Field 

Name 

Type 

Units 

Optional? 

Interpretation 

1 

<presence_vector> 

unsigned 

byte 

one 

false 

2 

<fixed_field> 

StreamType 

Unsigned 

byte 

one 

false 

Stream  type 

value  enum: 

0  =  RTSP 

1  =  MPEG2-TS 

2  ...  255  Reserved 

3 

<variable_length_string> 

StreamURL 

Count_field  = 

unsigned 

byte 

One 

False 

URL  of  the  source  of  the  stream.  This 

URL  should  not  require  a  DNS  to  resolve; 
hence,  an  IP  address  should  be 
substituted  for  a  host  name. 

4 

<bit  field> 

JAUS_ID 

Unsigned 

integer 

one 

true 

JAUS  ID  of  the  component  that  hosts  any 
configuration  and  control  services  for  this 
stream. 

Bits  0-7:  Component  ID 

Bits  8-15:  Node  ID 

Bits  16-31:  Subsystem  ID 

5 

<fixed_field> 

SensorlD 

unsigned 
short  integer 

one 

true 

The  ID  used  by  the  configuration  and 
control  service  to  identify  this  stream 
source. 

3. 7.4.2  Output  Set 

3. 7.4.2. 1  ID  F8A2:  ReportDigitalStreamEndpoint 

Reports  a  list  of  known  stream  sources.  Each  endpoint  is  represented  by  a  URL;  however,  the  URL  shall 
not  require  a  Domain  Name  Service  (DNS)  to  resolve.  In  addition,  each  stream  may  also  specify  a  JAUS 
ID  that  hosts  additional  SAE  JAUS  Services  for  the  configuration  and  control  of  the  stream,  as  well  as  a 
SensorlD  that  identifies  the  stream  source. 
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Table  3.7-3:  REPORT  DIGITAL  STREAM  ENDPOINT  MESSAGE  ENCODING 


body 

I _  list  name  =  ReportDigitalStreamEndpointList 

(count_field  =  unsigned  short  integer) 

record  name  =  EndpointCommonDataRec 

Record  Name  =  EndpointCommonDataRec 

Field# 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<fixed_field> 

EndpointCommonData 

unsigned  short  integer 

one 

faise 

3.7.5  Protocol  Behavior 


/  transport. Receiving 


events.  Ready 


A 

'  \ 

default 

^ _ } 

i 

Figure  3.7-2:  DIGITAL  STREAM  DISCOVERY  SERVICE  PROTOCOL  BEHAVIOR 


Table  3.7-4:  DIGITAL  STREAM  DISCOVERY  SERVICE  STATE  TRANSITIONS 


Label 

Trigger 

Conditions 

Actions 

A 

QueryDigitaiStreamEndpoint 

SendResponse  message 
‘ReportDigitaiStreamEndpoint’ 

RegisterDigitaiStreamEndpoint 

isRegisterType 

RegisterEndpoint 

RegisterDigitaiStreamEndpoint 

!  isRegisterType  && 
endpointExists 

RemoveEndpoint 

Table  3.7-5:  DIGITAL  STREAM  DISCOVERY  SERVICE  CONDITIONS 


Action 


Interpretation 
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isRegisterType 

True  if  the  message  that  triggered  this  transition 
specifies  the  RegistrationType  as  ‘Register’ 

endpointExists 

True  if  the  message  that  triggered  this  transition 
specifies  an  endpoint  that  exists  in  the  iist  of  known 
endpoints 

Table  3.7-6;  DIGITAL  STREAM  DISCOVERY  SERVICE  TRANSITION  ACTIONS 


Action 

Interpretation 

SendResponse 

Send  the  specified  response  message 

RegisterEndpoint 

Adds  the  specified  endpoint  to  the  iist  of  known 
endpoints 

RemoveEndpoint 

Removes  the  specified  endpoint  from  the  iist  of 
known  endpoints 

3.8  Preset  Pose  Service 

name=  Preset 
version=0.1 

id=urn:iop:platform:PresetPose 

Inherits-from  Managment 
name=events 

id=  urn:jaus:jss:core:Management 
version=1.0 


c<Transport»  ^ 


«Events» 


«AccessControl» 


sManagement»  K 


«Platform 
Pose  Driver» 


Figure  3.8-1:  PRESET  POSE  SERVICE 
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3.8.1  Description 

The  Preset  Pose  service  supports  querying  and  setting  of  preset  poses.  For  exampie,  a  Stow  pose  wouid 
be  a  configuration  of  piatform  manipuiators  and  other  actuators  that  best  prepare  it  to  be  stowed  away. 

3.8.2  Assumptions 

Messages  may  be  deiayed,  iost  or  reordered. 

3.8.3  Vocabulary 

Table  3.8-1:  PRESET  POSE  SERVICE  VOCABULARY 


Message  ID 
(hex) 

Name 

Command 

Input  Set 

FFFC 

QueryPresetPoses 

Faise 

FFFD 

SetPresetPose 

Faise 

Output  Set 

FFFE 

ReportPresetPoses 

faise 

3.8.4  Encoding 

3. 8.4.1  Input  Set 

3.8.4. 1. 1  ID  FFFDh:  SetPresetPose 

This  message  sets  the  desired  preset  pose.  It  will  cause  all  the  components  with  preset  poses 
to  move  to  those  positions. 

Table  3.8-2:  SET  PRESET  POSE  MESSAGE  ENCODING 


body 

L  record  name  = 

PoseRec 

Record  Name  =  PoseRec 

Field  # 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<flxed_fleld> 

Pose 

unsigned  byte 

One 

Faise 

Enum  0:  "Stow” 

Enum  1:  "Deploy” 

Enum  2:  "Drive” 

3.8.4. 1.2  ID  FFFCh:  QueryPresetPoses 

This  message  provides  a  way  for  a  ciient  to  get  information  about  the  preset  poses  that  the  piatform 
supports.  The  response  to  this  query  is  ReportPresetPoses  messages. 
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Table  3.8-3:  QUERY  PRESET  POSES  MESSAGE  ENCODING 


body 

^  (emntv) 

Empty  message  body 

3. 8.4.2  Output  Set 

3.8A.2. 1  ID  FFFEh:  ReportPresetPoses 

This  message  provides  the  preset  poses  that  are  supported  by  the  piatform. 

Table  3.8-4:  REPORT  PRESET  POSES  MESSAGE  ENCODING 


Body 

•-  SupportedPresetPoses 

Record  name  =  SupportedPresetPoses 

Field# 

Name 

Type 

Units 

Optional 

Interpretation 

1 

<bit_field> 

SupportedPoses 

unsigned  integer 

one 

faise 

Bitfield  of  supported  poses.  If  the  bit  is  high  ("1”), 
the  pose  is  valid  for  this  platform. 

Bit  0:  "Stow” 

Bit  1 :  “Deploy” 

Bit  2:  “Drive” 

3.8.5  Protocol  Behavior 


transnnrt.Rfinfiivinn 

eyen±s*Readv_ 


annfissCtrl  NntCnntrnllfir-j 


Management.StateA  ^ 


A 

default 

ac 


ccessCtrl. 


Controlled 


Management.StatqB 
B 


A 


Ready 


default 

i 

Figure  3.8-2:  PRESET  POSE  SERVICE  PROTOCOL  BEHAVIOR 
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Table  3.8-5:  PRESET  POSE  SERVICE  STATE  TRANSITIONS 


Label 

Trigger 

Conditions 

Actions 

A 

QueryPresetPoses 

sendReportPresetPoses 

B 

SetPresetPose 

isControllingClient  && 
isSupportedPose 

setPresetPose 

Table  3.8-6:PRESET  POSE  SERVICE  CONDITIONS 


Action 

Interpretation 

isControllingClient 

True  if  the  requester  of  action  is  the  controlling  client. 

isSupportedPose 

True  if  the  command  message  that  triggered  the 
transition  commands  a  pose  supported  by  this 
platform 

Table  3.8-7:  PRESET  POSE  SERVICE  TRANSITION  ACTIONS 


Action 

Interpretation 

sendReportPresetPoses 

Sends  a  ReportPresetPoses  message  with  a  list  of 
all  supported  preset  poses. 

setPresetPose 

Utilizes  platform  actuators  and  manipulator  to 
configure  system  into  specified  pose. 

4  Custom  Messages 

There  are  currently  no  custom  messages  defined. 

5  Custom  Transports 

For  the  UGV  lOP,  transports  are  specified  in  accordance  with  SAE  JAUS  AS5669A,  the 
JAUS/SDP  Transport  Specification.  Transports  that  are  specified  outside  of  AS5669A  or 
AS5669A  transport  modifications,  approved  for  use  within  the  UGV  lOP  will  be  specified  in  this 
section.  As  of  this  version  of  the  lOP,  there  are  no  defined  custom  transports  approved  for  use 
within  the  UGV  lOP. 
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6  Conformance  and  Validation  Requirements 

Specification  and  implementation  of  any  message  and/or  transport  defined  within  this  document 
shall  be  done  so  in  accordance  with  the  exact  specification  as  described  within  Section  4 
(custom  messages)  and  Section  5  (custom  transports)  as  applicable.  Implementation  of 
messages  and/or  transports  defined  within  this  document  shall  be  tested  via  demonstration 
methods  to  ensure  that  required  functions  and  capabilities  have  been  implemented  in 
accordance  with  the  corresponding  specification. 
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7  Appendix  A  -  Acronyms  and  Abbreviations 


ID 

Identifier 

lOP 

Interoperability  Profile 

JAUS 

Joint  Architecture  for  Unmanned  Systems 

SAE 

Society  of  Automotive  Engineers 

UGV 

Unmanned  Ground  Vehicle 
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